package com.scholarship.system.service;

import com.scholarship.system.common.dto.LoginRequest;
import com.scholarship.system.common.dto.LoginResponse;
import com.scholarship.system.common.dto.Result;
import com.scholarship.system.entity.User;

import java.util.List;

/**
 * 用户服务接口
 */
public interface UserService {

    /**
     * 登录
     *
     * @param loginRequest 登录请求
     * @return 登录响应
     */
    Result<LoginResponse> login(LoginRequest loginRequest);

    /**
     * 获取用户信息
     *
     * @param username 用户名
     * @return 用户信息
     */
    Result<LoginResponse.UserInfo> getUserInfo(String username);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户
     */
    User getByUsername(String username);

    /**
     * 获取用户列表
     *
     * @param role    角色
     * @param keyword 关键字
     * @return 用户列表
     */
    List<User> getUserList(String role, String keyword);

    /**
     * 添加用户
     *
     * @param user 用户信息
     */
    void addUser(User user);

    /**
     * 更新用户信息
     *
     * @param user 用户信息
     */
    void updateUser(User user);

    /**
     * 删除用户
     *
     * @param id 用户ID
     */
    void deleteUser(Long id);

    /**
     * 重置用户密码
     *
     * @param id 用户ID
     */
    void resetPassword(Long id);
}